home *** CD-ROM | disk | FTP | other *** search
/ Risc World 5 / Risc World 5.iso / SOFTWARE / Issue5 / PD / DIRSYNC / !DirSync / Theme / !ReadMe
Text File  |  2003-01-04  |  5KB  |  108 lines
  1.  
  2. What's going on here?
  3. ~~~~~~~~~~~~~~~~~~~~~
  4.   Rather than simply overwriting your favourite icons with mine, this
  5.   program supports multiple sets of icons, and auto-sensing to adapt
  6.   to the Theme or OS in use.
  7.  
  8. Isn't there a simpler way?
  9. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  10.   Some programs force RISC OS 3 style icons on RO4 users, or vice versa.
  11.   This is obviously counter-intuitive. Others supply RO3 and RO4 sprites
  12.   and choose which to use depending on your OS - which is fine - if you
  13.   haven't replaced the appalling RO4 icons with the superior RO3 ones, or
  14.   are using a Theme Manager to change the entire look of the desktop.
  15.   Neither approach will cope with a further change in OS style without
  16.   official updates or requiring YOU to change Obey files, etc.
  17.  
  18. But I don't use a Theme Manager!
  19. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  20.   That's OK, they are not necessary. If you are using one, the program
  21.   will try to adapt to the Theme in use. If not, it will adapt to the OS
  22.   in use, but you can override this.
  23.  
  24. Which sprites are used?
  25. ~~~~~~~~~~~~~~~~~~~~~~~
  26.   The Default scheme is ALWAYS loaded, then a Theme or OS specific file
  27.   is loaded, potentially changing some or all of the Default icons. In
  28.   the absence of a Theme Manager, icons suitable for your OS version will
  29.   be used. However, if a Theme Manager is running, it will have set a
  30.   system variable "Theme$Current", which will hold the name of the Theme
  31.   in use.
  32.   
  33. You said I could override these hateful sprites?
  34. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  35.   If you don't have a Theme Manager, you can STILL set Theme$Current to
  36.   the name of the Theme to use. If you don't want RO4 icons, you just
  37.   need to add "Set Theme$Current RO3" to an Obey file in your boot
  38.   sequence somewhere. If you have a calibrated monitor, use "RO3_Linear"
  39.   or "RO4_Linear".
  40.  
  41. Why oh why?
  42. ~~~~~~~~~~~
  43.   People change icons, fact. The supplied sprites may clash with your
  44.   curtains, or not match your carefully contrived blockbuster-tie-in
  45.   Theme. If you change the sprites in the program, then any upgrade is
  46.   going to destroy them again. If you don't copy the upgrade's sprite
  47.   file you will miss any new sprites we add and dreadful things will
  48.   happen. Having carefully adapted this program's sprites to your
  49.   cat-in-the-coal-cellar Theme you might want to share them with your
  50.   wide circle of friends, but you can't copy the program (please don't)
  51.   so how...
  52.  
  53. Where to put new sprites
  54. ~~~~~~~~~~~~~~~~~~~~~~~~
  55.   Sprites are looked for in the following locations:
  56.  
  57.     <Program>.Theme.Default.<sprites>
  58.     <Program>.Theme.<ThemeOrOS>.<sprites>
  59.     <Theme>.Apps.<Program>.<sprites>
  60.   
  61.   Firstly, this ensures that the default sprites are always loaded -
  62.   if we upgrade the program and add a sprite, you won't lose an icon
  63.   if using an older Theme - you'll just get one that doesn't match.
  64.   
  65.   Secondly, we can distribute Themed sprites within the program, for
  66.   whichever Themes we like. If you want to create your own versions,
  67.   create a directory inside <Program>.Theme with a unique name, say
  68.   "MyTheme". Put replacement sprite files in there - you only have to
  69.   include the sprites you have changed, which saves disc space. Now set
  70.   Theme$Current to "MyTheme" and hey presto!
  71.   
  72.   Thirdly, a Theme author can include sprites for this program within
  73.   the Theme itself - totally external from the program. Again, if this
  74.   program is updated before the Theme, things will still work fine.
  75.  
  76.   Fourthly, if there is no Theme, or an unrecognised Theme for which
  77.   the program has no directory and the Theme has no Program directory,
  78.   sprites suitable for your OS version will be used. The latest version
  79.   not greater than your OS version will be used from this list: RO2,
  80.   RO201, RO3, RO310, RO350, RO360, RO370, RO4, RO420, RO5. So, if you
  81.   are running Select, and the program has no Theme.RO240 directory, but
  82.   does have a Theme.RO4 directory, the RO4 icons will be used.
  83.  
  84. I want a Theme Manager!
  85. ~~~~~~~~~~~~~~~~~~~~~~~
  86.   The good Mr Richard Goodwin can help you, go to:
  87.   
  88.     <http://www.houseofmabel.com/programs/winthemes/index.html>
  89.  
  90. Can I do the same in my program?
  91. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  92.   The IconTheme utility is copyright © Cerilica 2002. You are hereby granted
  93.   a licence to include this utility within your application if and only if:
  94.  
  95.    • it is stored as !App.IconTheme
  96.    • this file is stored as !App.Theme.!ReadMe
  97.    • !App.Theme.Default contains ALL your sprites, not just !Sprites
  98.    • your default sprites are RO3 themed, preferably 16 colours no palette
  99.    • if you supply 256 colour sprites, eg RO4, you supply linear versions in
  100.      RO4_Linear by running them through ChangeFSI with a 0.454 gamma correction
  101.   
  102.  
  103.  
  104. Title:   Theme.!ReadMe
  105. Version: 1.01 (29-Aug-2002)
  106. Author:  Simon Birtwistle
  107. Contact: <mailto:simon@cerilica.com>
  108.